TPUG - Toronto PET Users Group/TPUG Users Group CD/TPUG Users Group CD.iso/CRS/crs17.d81/blkmagic.lnx/black magic docs.seq

Text File | 2009-10-10 | 13KB | 422 lines

  ┬╠┴├╦ ═┴╟╔├ ├OLOR╟RAPHIC ╟ENERATOR
  ----------------------------------

     ─OCUMENTATION ┬Y ┴.╠. ╨ETERS
  (├) 1988 ─ARK╙TAR ╙YSTEMS ╙OFT╫ARE


╘HIS EDITOR ALLOWS YOU TO CREATE COLOR
TEXT FILES USING 2 DISTINCT MODES OF
EDITING. ╔N THE FIRST METHOD, YOU TYPE
AWAY WHATAVER YOU WANT, AND IT WILL BE
ENTERED INTO THE BUFFER 'AS IS'. ╔N
THE SECOND METHOD, YOU USE THE COLOR
DRAW, BLOCK MOVE, AND SCREEN CAPTURE
OPTIONS TO COMPOSE 'SCREENS' OF TEXT,
WHICH CAN BE LINKED TOGETHER TO FORM
AN OVERALL TEXT FILE.

╫HEN YOU FIRST ENTER THE PROGRAM, YOU
WILL BE PLACED INTO EDIT MODE.
╔NITIALLY, BUFFERING WILL BE TURNED
OFF. ╘HIS MEANS THAT WHATEVER YOU TYPE
WILL NOT DISTURB THE CURRENT CONTENTS
OF THE EDIT BUFFER.

╨╥┼╙╙ ╞7 ╘╧ ╘╧╟╟╠┼ ┬╒╞╞┼╥╔╬╟ ╧╬/╧╞╞

╫HEN YOU DO THIS, THE '┼' INDICATOR IN
THE STATUS LINE WILL BE INVERTED WHEN
BUFFERING IS TURNED ON. ╬OW WHEN NOW
TYPE ANY CHARACTERS, THEY WILL BE SAVED
INTO THE BUFFER, WITH THE BUFFER COUNT
INCREASING AS YOU TYPE.

╘HE COLOR GRAPHICS EDITOR USES THE
STANDARD ─ARK╙TAR'88 COLOR PROTOCOL.
┘OU SHOULD BE FAMILIAR WITH THE USAGE
OF THE FEATURES OF THIS PROTOCOL.

╘╚┼ ─┼╠┼╘┼ ╦┼┘ ╔╙ ╬╧╘ ┬╒╞╞┼╥┼─.

┬E AWARE THAT WHEN YOU PRESS ─┼╠ TO
DELETE A CHARACTER, THE DELETE KEY WILL
NOT BE ENTERED INTO THE BUFFER. ╘HE
MOST RECENTLY ENTERED CHARACTER IN THE
BUFFER WILL BE DELETED FROM THE BUFFER
WHEN YOU PRESS ─┼╠. ╘HIS ALLOWS YOU TO
CORRECT TYPING MISTAKES EASILY.

╚OWEVER, YOU MAY WANT TO BUFFER DELETE
CHARACTERS IF YOU ARE COMPOSING AN
'ANIMATED' COLOR TEXT FILE. ╔N THIS
CASE, YOU SHOULD ENTER ├╘╥╠-─.

├╘╥╠-─ ╫╔╠╠ ┴── ─┼╠┼╘┼ ├╚┴╥┴├╘┼╥╙ ╔╬╘╧
╘╚┼ ┬╒╞╞┼╥.


         ┼DITOR ╧PTIONS
         --------------

     [╙] ╙AVE ┬UFFER ╘O ╞ILE
     [╠] ╠OAD ╞ILE ╔NTO ┬UFFER
     [┴] ┴PPEND ┬UFFER ╘O ╞ILE
     [═] ═ERGE ╞ILE ╫ITH ┬UFFER
     [╦] ╦ILL (├LEAR) ┬UFFER
     [┬] ┬LOCK ═OVE
     [├] ├APTURE ╙CREEN
     [─] ├OLOR ─RAW/╥EPLACE
     [╘] ╘EXT ╥EPLACE
     [╬] ╬EW ─ISK ─EVICE/─RIVE ╬UMBER
     [╫] ─╧╙ ╫EDGE
     [╞] ╥EAD ┴ ╞ILE
     [╥] ╥EVIEW ┬UFFER
     [╤] ╤UIT ╨ROGRAM


╘HE BUFFER CAPACITY FOR THE EDITOR IS
REDUCED BECAUSE OF THE DISPLACEMENT BY
THE EDITOR PROGRAM ITSELF. ┘OU HAVE
AVAILABLE 90 BLOCKS OR ABOUT 23,000
CHARACTERS FOR THE BUFFER.

╘HE EDITOR ONLY WORKS WITH ╙┼╤ TYPE
FILES. ┘OU MAY ONLY APPEND TO A ╙┼╤
TYPE FILE.

     ┬LOCK ═OVE [┬]

╘HE BLOCK MOVE ALLOWS YOU TO PICK UP OR
COPY A PORTION OF THE SCREEN AND STAMP
IT DOWN ONTO ANOTHER AREA OF THIS
SCREEN. ┘OU ALSO HAVE THE OPTION TO
SAVE THE BLOCK YOU GRAB ONTO DISK SO
THAT IT CAN BE RECALLED LATER.

╫HEN YOU ACCESS THE BLOCK MOVE COMMAND,
YOU WILL BE PROVIDED WITH 5 BLOCK
OPTIONS:

     [╠] ╠OAD ╘EXT ┬LOCK ╞ROM ─ISK
     [╙] ╙AVE ╘EXT ┬LOCK ╘O ─ISK
     [├] ├OPY ┴ ╘EXT ┬LOCK
     [═] ═OVE ┴ ╘EXT ┬LOCK
     [╥] ╥E-USE ╨REVIOUS ╘EXT ┬LOCK

╘EXT BLOCKS ARE SAVED IN A SPECIAL
BLOCK IMAGE FORMAT. ╔F YOU TRY TO LOAD
A NON-BLOCK INAGE, THE FILE WILL BE
REJECTED. ╧NLY ONE BLOCK MAY BE IN
MEMORY AT A TIME. ┘OU MAY PREFORM ANY
OTHER EDIT OPTIONS AND KEEP THE CURRENT
BLOCK IN MEMORY FOR USE AT ANY TIME.

┘OU CAN SPECIFY THE RE-USE OPTION TO
USE THE MOST RECENTLY ACTIVE TEXT BLOCK
IN MEMORY. ╔F YOU USE THE LOAD OPTION
ABOVE, YOU SHOULD USE THE RE-USE OPTION
INSTEAD OF THE COPY OR MOVE OPERATIONS.

╔F YOU ELECT TO COPY A BLOCK, THE TEXT
YOU GRAB FROM THE SCREEN WILL BE
PLACED INTO THE BLOCK MEMORY BUFFER,
BUT THE SCREEN WILL REMAIN UN-AFFECTED.
╔F YOU MOVE A BLOCK, THE AREA OF THE
SCREEN YOU GRABBED WILL BE REMOVED FROM
THE DISPLAY, CREATING A HOLE.

╔N EITHER CASE, YOU MUST POSITION THE
CURSOR TO THE UPPER LEFT CORNER OF
A RECTANGULAR AREA TO GRAB. ╨RESS
╙╚╔╞╘-╥┼╘╒╥╬ TO MARK THIS POSITION.
╘HEN MOVE THE CURSOR TO THE LOWER RIGHT
CORNER OF THE GRAB AREA AND PRESS
╙╚╔╞╘-╥┼╘╒╥╬ ONCE MORE. ╔F YOU
SPECIFIED MOVE MODE, THE AREA OF THE
SCREEN WILL BE LIFTED OFF FROM THE
DISPLAY. ╬OTE THAT THE BLOCK WILL NOT
BE VISIBLE AS YOU MOVE THE CURSOR TO A
NEW POSITION. ┘OU WILL HAVE TO KEEP
TRACK OF THE BLOCK WIDTH AND HEIGHT
WHEN DECIDING WHERE TO MOVE/COPY THE
BLOCK TO.

┴T THIS POINT, YOU WILL BE PROMPTED TO
SELECT A NEW POSITION FOR THE TEXT
BLOCK. ╔F YOU SELECTED THE RE-USE
OPTION, YOU WILL PROCEED HERE
IMMEDIATELY. ┘OU WILL NOTICE A GRAPHIC
SYMBOL IN THE STATUS LINE. ╘HIS GRAPHIC
SHOWS A SMALL SQUARE WITHIN A LARGER
SQUARE. ┬EFORE YOU PRESS ╙╚╔╞╘-╥┼╘╒╥╬
TO STAMP THE BLOCK ON THE SCREEN, YOU
CAN ENTER ONE OF THE FOLLOWING:

[╞1] ├URSOR ╔N ┬LOCK ╒PPER-╠EFT ├ORNER
[╞3] ├URSOR ╔N ┬LOCK ╒PPER-╥IGHT ├ORNER
[╞5] ├URSOR ╔N ┬LOCK ╠OWER-╥IGHT ├ORNER
[╞7] ├URSOR ╔N ┬LOCK ╠OWER-╠EFT ├ORNER
[╘]  ╘OGGLE ╘RANSPARENCY ═ODE
[├╠╥] ├LEAR ╙CREEN ╧F ┴LL ╘EXT

╫HEN YOU PRESS ONE OF THE FUNCTION KEYS
THE GRAPHIC SYMBOL WILL CHANGE TO SHOW
WHERE THE CURSOR WILL BE RELATIVE TO
ONE OF THE 4 CORNERS OF THE TEXT BLOCK.
╘HE INITIAL VALUE IS THE UPPER LEFT
CORNER, WHICH MEANS THE BLOCK WILL BE
STAMPED TO THE RIGHT AND DOWN FROM THE
CURSOR POSITION. ┘OU SHOULD EXPERIMENT
TO SEE HOW EACH CORNER POSITION WORKS.

╘RANSPARENCY MEANS THAT ANY SPACES IN
THE TEXT BLOCK WILL BE TREATED AS AREAS
OF 'NO DATA'. ╫HEN THE BLOCK IS PLACED
ON THE SCREEN, ANY AREAS ON THE SCREEN
THAT ARE UNDER THESE SPACES WILL SHOW
THROUGH. ╘RY THIS OPTION TO SEE HOW IT
WORKS. ╬ORMALLY, YOU WILL BE USING
NON-TRANSPARENCY MODE. ╘HE ╘ INDICATOR
IN THE STATUS LINE WILL BE INVERTED
WHEN TRANSPARENCY MODE IS ENABLED.

╨RESS ╙╚╔╞╘-╥┼╘╒╥╬ TO STAMP THE IMAGE
ONTO THE SCREEN. ╘HE BLOCK MOVE COMMAND
IS SMART; IT WILL PERFORM HORIZONTAL
AND VERTICAL CLIPPING OF THE TEXT BLOCK
IF IT EXTENDS BEYOND THE BOUNDARIES OF
THE SCREEN.

╫HILE ACCESSING THE BLOCK MOVE OPTION,
THE SCREEN DISPLAY WILL BE LOCKED FROM
SCROLLING UP OR DOWN. ╘HIS ENSURES THAT
YOU WILL NOT DESTROY THE SCREEN BY
INADVERTENTLY MOVING THE CURSOR PAST
THE FIRST OR LAST LINES OF THE DISPLAY.

┘OU CAN ABORT THE BLOCK MOVE AT ANY
TIME BY PRESSING THE ╥┼╘╒╥╬ OR ╙╘╧╨
KEYS. ┘OU CAN STAMP THE TEXT BLOCK AS MANY TIMES AS YOU WANT UNTIL YOU PRESS
ONE OF THESE 2 KEYS. ┘OU CAN USE THE
GRAB PART OF A BLOCK MOVE TO STORE A
TEXT BLOCK, AND ABORT AT THIS POINT SO
THAT YOU CAN USE THE RE-USE OPTION
LATER.

     ╙CREEN ├APTURE [├]

╘HIS OPTION ALLOWS YOU TO TAKE THE
CURRENT SCREEN DISPLAY AND STORE IT IN
THE BUFFER AS A FINAL CLEAN IMAGE, FREE
OF ALL CURSOR MOVEMENT, EDITING, AND
CORRECTING KEYSTROKES. ╘HE CAPTURE WILL
WORK IN TWO DISTICNT MODES, DEPENDING
ON WHETHER BUFFERING IS ENABLED OR NOT.

╔F BUFFERING IS ENABLED AND YOU PERFORM
THE CAPTURE, THE IMAGE WILL BE APPENDED
TO THE END OF THE BUFFER. ╘HIS MEANS
THAT YOU CAN CHAIN SCREEN IMAGES
TOGETHER BY USING THE CAPTURE OPTION
AS MANY TIMES AS IS NECESSARY. ┘OU MUST
HAVE BUFFERING TURNED ON FOR CHAINING
TO WORK.

╔F BUFFERING IS DISABLED (┼ INDICATOR
IS NOT INVERTED), THEN A CAPTURE WILL
CLEAR THE OLD CONTENTS OF THE BUFFER,
AND SAVE THE IMAGE TO THE START OF AN
EMPTY BUFFER.

╔F YOU SPECIFY A FULL CAPTURE, THE
ENTIRE 23 LINE SCREEN WILL BE CAPTURED,
ALONG WITH THE BORDER, BACKGROUND, AND
TEXT COLORS. ┴ CLEAR SCREEN CHARACTER
AND APPROPRIATE ─ARK╙TAR'88 COLOR
FUNCTION KEYS FOR SETTING SCREEN COLORS
WILL BE PLACED AT THE START OF THE
EDIT BUFFER. ╘HE CAPTURED IMAGE WILL
FOLLOW THIS IN THE BUFFER.

┴ NORMAL CAPTURE OCCURS WHEN YOU DO NOT
SPECIFY A FULL CAPTURE. ╔N THIS CASE,
THE CURSOR ROW THAT YOU LEFT OFF AT
WHEN YOU PRESSED THE ╙╘╧╨ KEY TO ACCESS
THE CAPTURE OPTION WILL BE THE LAST ROW
OF THE SCREEN THAT WILL BE STORED IN
THE IMAGE. ╞OR EXAMPLE, IF THE CURSOR
IS ON ROW 10 WHEN YOU SELECT A NORMAL
CAPTURE, ONLY THE FIRST 10 LINES OF THE
SCREEN WILL BE SAVED IN THE BUFFER.

┘OU CAN USE THESE TWO CAPTURE MODES TO
CREATE A LINKED TEXT FILE OF CAPTURED
SCREENS. ├REATE THE FIRST SCREEN, AND
SPECIFY FULL CAPTURE TO STORE THE
INITIAL IMAGE WITH THE PROPER SCREEN
COLORS. ╞OR EACH SUBSEQUENT SCREEN, USE
NORMAL CAPTURE WITH THE CURSOR
POSITIONED AT THE LAST ROW OF TEXT TO
CAPTURE. ═AKE SURE THAT WHILE YOU
CREATE EACH SCREEN, TURN OFF BUFFERING
WITH ╞7 WHILE IN EDIT MODE. ╨RESS ╞7
AGAIN BEFORE YOU PRESS ╙╘╧╨ TO ACCESS
CAPTURE, SO THAT THE NEW IMAGE WILL BE
APPENDED TO THE BUFFER WITHOUT CLEARING
IT FIRST.

     ├OLOR ─RAW/╥EPLACE [─]

╘HIS OPTION ALLOWS YOU CHANGE OR
REPLACE THE TEXT COLOR OF ANY AREA ON
THE SCREEN.

╘HE SOURCE COLOR IS THE COLOR THAT YOU
WANT TO REPLACE. ─O NOT ENTER A COLOR
NUMBER (IE 0-15). ┼NTER THE ACTUAL
COLOR CHARACTER. ╞OR EXAMPLE, TO CHANGE
RED, PRESS ├╘╥╠-3.

╘HE TARGET COLOR IS THE ONE THAT YOU
WANT TO REPLACE THE SOURCE COLOR WITH.

├OLOR FILL MEANS THAT THE SCREEN BLOCK
YOU DEFINE WILL BE FILLED WITH THE
TARGET COLOR. ╔N THIS CASE, THE SOURCE
COLOR WILL BE IGNORED. ┘OU CAN ENTER
ANY COLOR FOR THE SOURCE IF YOU ARE
GOING TO USE COLOR FILL: ONLY THE
TARGET COLOR COUNTS.

╔F YOU DO NOT SPECIFY COLOR FILL, ONLY
THE SOURCE COLOR IN THE DEFINED BLOCK
WILL BE REPLACED WITH THE TARGET COLOR.
┴LL OTHER COLORS WILL BE SKIPPED OVER.

┴FTER PROVIDING THE SOURCE/TARGET
COLORS AND SPECIFYING FILL/UNFILL MODE,
YOU MUST POSITION THE CURSOR TO THE
UPPER LEFT CORNER OF THE TEXT BLOCK YOU
WANT. ╨RESS ╙╚╔╞╘-╥┼╘╒╥╬ TO MARK THIS
POSITION, THEN MOVE THE CURSOR TO THE
LOWER RIGHT CORNER OF THE TEXT BLOCK
AND PRESS ╙╚╔╞╘-╥┼╘╒╥╬ A SECOND TIME.
╘HIS DEFINITION PROCEDURE IS EXACTLY
THE SAME AS THE BLOCK MOVE PROCEDURE.

┘OU CAN DO A COLOR FILL/REPLACE WITH
THE SAME SOURCE/TARGET COLORS AS MANY
TIMES AS YOU WANT. ╨RESS ╙╘╧╨ OR ╥┼╘╒╥╬
TO ABORT THE COLOR DRAW AT ANY TIME.

╘HE ABOVE 3 OPTIONS: BLOCK MOVE, COLOR
DRAW, AND SCREEN CAPTURE, ARE SCREEN
ORIENTED COMMANDS. ┘OU SHOULD USE THE
CAPTURE OPTION AFTER YOU ARE DONE WITH
A BLOCK MOVE OR COLOR DRAW TO UPDATE
THE EDIT BUFFER.

     ╘EXT ╥EPLACE [╘]

╘HIS OPTION OPERATES ON THE ENTIRE
CONTENTS OF THE BUFFER. ╘EXT REPLACE IS
A SIMPLE SEARCH AND REPLACE PROCEDURE.
┴T THE ╙: PROMPT, ENTER A 1 TO 37
CHARACTER SEARCH STRING. ┘OU CAN SEARCH
AND REPLACE ┴╬┘ TYPE OF DATA, SUCH AS
COLOR CHARACTERS OR CURSOR MOVEMENTS.
┴S YOU ENTER THE CHARACTER DATA, IT
WILL BE ECHOED IN SCREEN CODE FORMAT.

╬OTE THAT BECAUSE ╥┼╘╒╥╬ AND ─┼╠ ARE
USED TO END AND BACKSPACE THE INPUT
LINE, YOU MUST USE ALTERNATIVE KEYS TO
SEARCH AND REPLACE RETURN AND DELETE
CHARACTERS IN THE BUFFER. ┼NTER ├╘╥╠-─
TO SEARCH/REPLACE DELETE CHARACTERS,
AND ╙╚╔╞╘-╥┼╘╒╥╬ TO SEARCH/REPLACE
RETURN CHARACTERS.

┴T THE ╥: PROMPT, ENTER A 1 TO 37
CHARACTER REPLACEMENT STRING. ┘OU
CANNOT ENTER NULL STRINGS (NO INPUT).
╞OR EXAMPLE, IF YOU WANTED TO SEARCH
FOR THE STRING '╬╧╘╚╔╬╟' AND REMOVE IT
BY SPECIFYING NO REPLACEMENT TEXT,
YOUR REQUEST WILL BE REJECTED. ┘OU WILL
HAVE TO INCLUDE THE CHARACTER TO THE
LEFT OR RIGHT OF THAT SEARCH TEXT IN
THE SEARCH STRING, AND USE THE THAT
ONE CHARACTER AS THE REPLACEMENT TEXT.

╘HE REPLACEMENT TIME VARIES WITH THE
AMOUNT OF DATA IN THE BUFFER. ╔T CAN
TAKE A FEW SECONDS FOR MANY
REPLACEMENT OPERATIONS.

     ╥EVIEW ┬UFFER [╥]

╫HILE REVIEWING THE BUFFER, YOU CAN
USE ANY OF THE FOLLOWING KEYS:

╙╚╔╞╘-╙╘╧╨: ┼NTER ╙INGLE ╙TEP ═ODE
╙╨┴├┼     : ╨AUSE ╧UTPUT
╙╘╧╨      : ┴BORT ╥EVIEW
╙         : ╘OGGLE ─ISPLAY ╙PEED
╘         : ╘RUNCATE ┬UFFER

╫HEN YOU TRUNCATE THE BUFFER, THE
REMAINDER OF THE BUFFER AFTER THE
CHARACTER YOU PRESS THE ╘ KEY AT WILL
BE DELETED FROM THE EDIT BUFFER. ┘OU
WILL THEN BE PLACED INTO EDIT MODE.

╔F YOU LET THE REVIEW CONTINUE TO THE
END, YOU WILL BE PLACED BACK INTO EDIT
MODE, WHERE YOU MAY RESUME ENTERING
TEXT.

╙INGLE STEP MODE ALLOWS YOU TO STEP
THROUGH THE BUFFER ONE CHARACTER AT
A TIME. ╧NCE YOU ARE IN SINGLE STEP
MODE, OUTPUT WILL STOP AFTER EACH
CHARACATER IS DISPLAYED. ╨RESS ╙╚╔╞╘
╥┼╘╒╥╬ TO ADVANCE TO THE NEXT CHARACTER
IN THE BUFFER. ╨RESS ╙╚╔╞╘-╙╘╧╨ TO EXIT
SINGLE STEP MODE AND RESUME THE REVIEW.

╔F YOU ENTER ANY OTHER CHARACTER, IT
WILL REPLACE THE CHARACTER THAT WAS
JUST DISPLAYED. ╞OR EVERY CHARACTER
YOU CHANGE, AN ASTERISK (*) WILL BE
DISPLAYED. ╬OTE THAT ALTHOUGH THIS CAN
DISTORT THE OUTPUT, ESPECIALLY WHEN
CHANGING COLOR CHARACTERS OR OTHER
NON-PRINTABLES, A SUBSEQUENT REVIEW
WILL SHOW THE PROPER CHANGES.

╔N THE ─╧╙ WEDGE, ENTER $ TO DISPLAY
THE DISK DIRECTORY. ╒SE ╙╘╧╨ AND ╙╨┴├┼
TO CONTROL THE OUTPUT.

╫HEN READING A FILE, USE THE ╙╘╧╨ AND
╙╨┴├┼ KEYS TO CONTROL THE OUTPUT. ╘HE
FILE DISPLAY WILL OVERWRITE THE SCREEN
DISPLAY. ╒SE THE REVIEW OPTION TO
RESTORE THE ORIGINAL SCREEN COLORS AND
TEXT.

╘HE ╬ OPTION ALLOWS YOU TO ENTER A NEW
DEVICE NUMBER FROM 4 TO 63 AND A NEW
DRIVE NUMBER FROM 0 TO 9. ╘HE DRIVE
NUMBER ENTRY IS OPTIONAL. ╞OR EXAMPLE,
ENTER '12,0' TO ACCESS FILES ON THE
DRIVE WITH DEVICE 12, DRIVE NUMBER 0.
┼NTER '9' TO CHANGE TO DEVICE #9, WHILE
KEEPING THE SAME DRIVE NUMBER.